home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / avgz20.zip / READ.ME < prev   
Text File  |  1990-09-26  |  6KB  |  124 lines
  1.                             AverageZ v2.0
  2.                  Copyright 1989-1990 Average Software
  3.  
  4.                         Another Average Utility
  5.                                  From:
  6.                             Average Software
  7.                      "The Epitome Of Mediocrity" tm
  8.                        Ken Rieck and Dave Masters
  9.  
  10.                 Call the Average Software Support Board
  11.                                Data Trax
  12.                          Oceanside, California
  13.                              (619) 433-8564
  14.                         Up to 38400 USR HST 1441
  15.  
  16. This is going to be short because I hate reading documentation too.
  17.  
  18. DESCRIPTION
  19. -----------
  20. AverageZ was initially written over a period of one week using Turbo Pascal 
  21. 5.5 while trying to teach ourselves pascal.  It started when it was 
  22. realized that the LOG file that DSZ can create and maintain has a lot of 
  23. useful information, but in it's natural form the information isn't easy to 
  24. grasp as a whole.  AverageZ will read the LOG file and compile the all the 
  25. lines into one, useful screen of information.  The screen is divided into 
  26. ZModem transfers on the left, and all other protocols (like YModem, 
  27. YModem-G, XModem, etc.) on the right side.  Version 1.1 will be the last 
  28. release of AverageZ.  Due to the limitations of DSZ's logging capabilities, 
  29. there are only two things that you can tell from looking at the log file; 
  30. whether it was a ZModem transfer or a XModem/YModem transfer.  We will 
  31. continue to support AverageZ through the Average Software Support Board 
  32. which is listed at the end of this document.
  33.  
  34. USEAGE
  35. ------
  36. Running AverageZ is easy, you simply invoke it by typing:
  37.  
  38.     AverageZ [logfilename.ext] [/O<reportfilename.ext>]
  39.  
  40. on the command line, [logfilename.ext] is optional.  If you have the DSZLOG 
  41. environment variable set, AverageZ will read it and process the file that 
  42. it points to.  If you have this variable set, but want to process a 
  43. different LOG file, putting it on the command line will override the 
  44. environment setting.  Averagez now has the capability to optionally write 
  45. its report to disk.  If you want your compiled DSZ log statistics written 
  46. to a file, add /O<filename> to your command line.  <Filename> can be any 
  47. valid DOS file name including path (if desired), and must be included if 
  48. you specify '/O' on the command line.
  49.  
  50. There are only two errors that AverageZ looks for in your log file: if the 
  51. file doesn't exist or if the file is in the wrong format.  If it is in the 
  52. wrong format, AverageZ abort with a message telling you the line number(s) 
  53. (in the LOG file) where the error(s) occurred and you can then edit the LOG 
  54. to remove or correct the erroneous line(s).  Below is a sample of what a 
  55. proper DSZ LOG file line looks like:
  56.  
  57. Z 166947 19200 bps 1084 cps   0 errors     0  128 world27.zip 0
  58. ^   ^      ^         ^        ^            ^   ^      ^       ^
  59. │   │      │         │        │            │   │      │       └ S/N
  60. │   │      │         │        │            │   │      └ Filespec
  61. │   │      │         │        │            │   └ Block Size
  62. │   │      │         │        │            └ Flow Control
  63. │   │      │         │        └ Error Count
  64. │   │      │         └ Characters Per Second
  65. │   │      └ Comm Port Speed
  66. │   └ File Size
  67. └ Protocol Used
  68.  
  69. There's no need to go into depth about all the different items on each
  70. line, if you want more information about it, consult the DSZ
  71. documentation.
  72.  
  73. AverageZ can now handle entries made by another program called LOGDATE.  
  74. LOGDATE is normally run immediately prior to calling DSZ for a file 
  75. transfer, and will put a time/date stamp in your DSZ log file.  LOGDATE is 
  76. not included in the AverageZ package, and if you're interested in obtaining 
  77. the program, you should be able to download it from a local BBS.
  78.  
  79. AverageZ will trap up to nine incorrectly formatted lines in your log 
  80. file.  If your LOG has bad lines in it, simply use a straight ASCII 
  81. editor (like QEDIT) to fix the problem.
  82.  
  83. If you haven't set the DSZLOG variable in your environment, you should
  84. add:
  85.  
  86.       SET DSZLOG=<filespec>
  87.  
  88. to your AUTOEXEC.BAT file.  Once you do this, DSZ will maintain a log of
  89. all your transfers.  Again, if you want more information about the DSZLOG=
  90. environment variable, consult the DSZ documentation.
  91.  
  92.  
  93. If you like the program, then tell your friends about it and upload it to
  94. your favorite BBS.
  95.  
  96. ACKNOWLEDGEMENTS
  97. ----------------
  98. Omen Technologies - Without them, this program wouldn't have a reason to 
  99.                     exist.
  100. Chris Mueller     - For the tip that led to the LOGDATE entry handling. 
  101. Chris Conrad      - Requested redirection capability.
  102. You               - For downloading and trying this program.
  103.  
  104. DISCLAIMER
  105. ----------
  106. AverageZ is provided on an "as is" basis without warranty of any kind 
  107. expressed or implied. In no event will Average Software be liable to you 
  108. for any damages, including any lost profits, lost savings or other 
  109. incidental or consequential damages arising out of the use of or inability 
  110. to use the program, even if Average Software has been advised of the 
  111. possibility of such damages, or for any claim by any other party.
  112.  
  113. BUG REPORTS
  114. -----------
  115. If you find any bugs, we'd appreciate a call to the Average Software
  116. Support Board - Data Trax (619) 433-8564.  Data Trax features near-instant
  117. verification and security upgrade using the PCBVerify callback door, so
  118. you call once, get callback verified, and then your access is upgraded
  119. instantly.  If you'd rather not call, then you can send a postcard to:
  120.  
  121.                              Average Software
  122.                              1837 S. Myers St. #7
  123.                              Oceanside, CA 92054
  124.